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INTRODUCTION 


This manual contains information concerning the Langley VEDIT 
utility line editor on the Control Data Network Operating 
System/Virtual Environment (NOS/VE) . 

The EDIT_FILE_LINE_MODE (or VEDIT) command utility enables you to 
edit files (local or permanent) line by line. These files can 
contain either source programs, data, or text (listable files). 
The user should not use this utility to edit binary files. 

This manual explains how to access and use VEDIT. Examples and 
illustrations help the user with each command. 

AUDIENCE 


This manual is intended for a user which is familiar with the 
interactive use of NOS/VE. Some knowledge of how to manipulate 
NOS/VE files is helpful but is not required. For information on 
the interactive use of NOS/VE, refer to the System Command 
Language (SCL) System Interface Manual. 

This manual is divided into two parts. The first part describes 
the basics of the editor. The second part describes all the 
utility subcommands. This information is listed alphabetically 
by subcommand names. 

VEDIT FEATURES 


The following are features of VEDIT: 

- Simple command formats using the 
commands . 

- Vex. if ^cation of user entries , VEDIT 
file lines modified by a command. 

- Easy line modification. 

- Available for batch processing. 


same syntax 

A •*» -A- *••<• A 1 1 »» 1 

au uuma orvax. ju jr x 


as 


SCL 


REFERENCE MANUALS CONVENTIONS 

The EDIT_FILE_LINE_MODE command utility is an extended 
interactive, line-oriented text editor developed by Margaret A. 
Heaney, CSB/ACD, NASA Langley, based on XEDIT on the Control Data 
Corporation Network Operating System (CDC NOS) and using command 
utilities on NOS/VE. 

This manual describes this utility's use. The basis of the 
material for the commands and their syntax has been taken from 
the CDC XEDIT Version 3 Reference Manual (publication number 
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60455730). It is assumed that the user is familiar with NOS/VE 
operations and file concepts. 

The subcommand descriptions within this manual follow a standard, 
concise format. The format is described on page 16 of this 
manual and is the same format used for other SCL commands (refer 
to the SCL Language Definition manual for detailed information) . 
In the descriptions of subcommands or parameters, valid 
abbreviations are shown in parentheses. 

In the examples, the user input is printed in lower case letters, 
and VEDIT output is printed in uppercase letters. 
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CALLING VEDIT 


The user can call VEDIT from a time-sharing terminal by using the 
EDIT_FILE_LINE_MODE command, where editing commands can be given 
interactively. In a batch environment the EDIT_FILE_LINE_MODE 
utility call implements the utility, where a set of utility sub- 
commands is processed without further user direction. 


INITIATING VEDIT 

The user initiates VEDIT by using the format: 

ED I T_F I LE_L I NE_MODE ( ED I FLM , VED I T ) 

INPUT_FILE 

FSTAT 

INPUT 

OUTPUT 

STATUS 

The INPUT_FILE(F) parameter specifies the name of the file you 
want to edit and is a required parameter. 

If the FSTAT parameter is specified as a key of "c" (at present, 
the only available option), VEDIT begins execution in creation 
mode. While, in creation mode, only the following commands are 
valid: INSERT_LINE and STOP. VEDIT leaves creation mode when a 

line of text exists within the file. Normal editing can follow. 
Upon exit, a file is generated with the name specified in the 
VEDIT command. If the full path is not given, the file is 

created in the user's current working catalog. If omitted, the 
file must contain at least one line of text; otherwise, the 
system prints 


EMPTY OR FILE NOT FOUND 
NAME EDIT FILE? 


INTERACTIVE USAGE OF VEDIT 

The interactive user issues the command to call the VEDIT 
program. Output is printed at the terminal using the existing 
character set mode. After the VEDIT command is entered, the 
system replies: 

NOS/VE VEDIT date and time 
VED/ 

This message indicates that the VEDIT program is initiated and 
awaiting commands. 
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VEDIT CONVENTIONS 


All VEDIT commands follow the same basic pattern in their syntax 
and parameters and in their required editing data. Knowledge of 
the basic pattern leads to fewer user errors while editing. 


VEDIT COMMAND SYNTAX 

VEDIT prints the prompt "VED/" whenever it expects the user to 
enter a VEDIT command. The syntax for a VEDIT command is the 
same as SCL commands. 

A legal command conforms to the following conventions: 

- The command must be spelled correctly. 

- Command parameters must follow the sequence shown in that 
command's description. 

- Command parameters must stay within their maximum and 
minimum numerical limits. 

- The command must be entered at the position where the 
terminal print element stopped after printing the prompt, 
"VED/" . 

- The command must be separated from its parameters by a 
space or other delimiter and, for string parameters, the 
string delimiter must also be used. 

- Extra spaces may appear between command parameters. 

- VEDIT initiates its search for a given line or string at 
the current pointer position. 

If the user does not enter a valid command after the prompt 
"VED/", VEDIT prints an error message and another prompt. 


ENTERING EDITING DATA 

VEDIT commands often require that the user enter data indicating 
how the file should be modified. When editing data is needed, 
VEDIT prints a single question mark prompt (?). Editing data is 
requested for the INSERT_LINE and the I NSERT_L I NE_BEFORE 
commands . 

If the user enters only a carriage return after the single 
question mark (?) , VEDIT prints the prompt "VED/" indicating that 
the command was not processed and that the user can enter the 
next editing command. 
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POSITIONING THE FILE POINTER 


During editing, VEDIT keeps track of its location within the file 
by means of a pointer. The pointer is always located at the 
start of the line and is positioned according to these rules. 


Condition 


Pointer Position 


VEDIT is called. 


Beginning-of- information. 


A command is Last line processed by the command 

processed. (usually the last line printed) . 


Command process- 
ing reaches the 
end-of- informat- 
ion. 


The message -- EOI/TOP -- is 

printed, further processing of the 
command stops, and the pointer is 
repositioned at the beginning of the 
file. 


LOCATING LINES VIA SPECIFIED STRINGS 

The user can advance the pointer to a line containing a specific 
string of alphanumeric characters by issuing the LOCATE_STRING 
command. LOCATE_STRING allows you to find lines containing a 
specified string. When the user issues the LOCATE_STRING 
command, VEDIT prints the specified number of lines containing 
the specified string. The pointer is positioned at the last line 
printed . 


ADVANCING AND REVERSING THE POINTER 

When the user wants to advance the pointer toward the end of the 
file, the MOVE_TO_NEXT_LINE command is entered. When the user 
wants to reverse the pointer toward the beginning-of- 
information, MOVE_TO_NEXT_LINE command specifying a negative 
number of lines is used. Reverse pointer movements using the 
MOVE_TO_NEXT_LINE command are much slower than forward pointer 
movements . 


POSITIONING POINTER AT TOP AND BOTTOM OF THE FILE 

A user can position the pointer at the beginning-of-information 
by issuing a MOVE_TO_TOP command. The user can move the pointer 
to the bottom of a file by issuing a MOVE_TO_BOTTOM command. 
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POSITIONING POINTER BY LISTING LINES 


A user can list lines from a file with the PRINT_LINE command. 
This command begins its listing at the current pointer position. 
When the listing is finished, the pointer is positioned at the 
last line printed. If VEDIT reads an end-of-information mark, 
printing stops and the pointer is positioned at the beginning of 
the file. 
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STRING EDITING 


The user can modify specific strings of alphanumeric characters 
within a file line by issuing one of the string editing commands, 
CHANGE_STR I NG or CHANGE S_STR I NG. 

REPLACING, DELETING, AND INSERTING STRINGS 

Both commands can: 

Replace one string with a different string. 

Delete strings from file lines. 

Insert strings at the beginning of a line. 


The user can replace one string with a different string of any 
length and character content with both commands. However, to use 
the edited file within NOS/VE, the user should not create a file 
line longer than 80 characters. The search for the first 
specified string starts at the line designated by the current 
pointer position. 

The commands can also be used to delete a string by omitting the 
replacement string. This command begins editing at the current 
line position and continues through the specified number of 
lines . 

A user can insert before the first (leftmost) character of a line 
using these commands. To do this, the replaced string must be 
omitted. 

The CHANGE_STR I NG command changes every occurrence of the 
specified string in each of the specified number of lines. 

The CHANGE S_STR I NG command changes a specific number of 
occurrences of the string in as many lines as necessary. 
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LINE EDITING 


A user can delete entire lines from a file by using any of the 
following criteria. 

- A sequence of lines starting at the current pointer 
position. 

- Selective lines on the basis of a specified string. 

- A single line with a specified string without moving the 
file pointer if the string is not found. 

These criteria use the DELETE_LINE command. The DELETE_LINE 
command leaves the file pointer positioned at the line after the 
last line deleted. 

The user can insert entire new lines into a file, without 
affecting any existing lines, in two different ways. 

- INSERT_LINE command inserts a specified number of lines 
after the current pointer position. 

- INSERT_LINE_BEFORE command inserts a specified number of 
lines before the current pointer position. 

When the user enters the INSERT_LINE command, VEDIT prints a 
single question mark to prompt entry for the first line to be 
inserted. VEDIT continues to print single question mark prompts 
until the specified number of lines to be inserted has been 
entered. If the user enters a carriage return immediately after 
the (?) prompt VEDIT stops processing the INSERT command and 
requests the next command. To insert a blank line, the user 
enters a space before the carriage return. After processing an 
INSERT_LINE command, the file pointer is positioned at the last 
line inserted. 

When the user wants to insert a specific number of lines into a 
file before the line at the current pointer position, an 
INSERT_LINE_BEFORE command is issued. Entry of the lines to be 
inserted is the same as for the INSERT_LINE command. The first 
line entered is the first line of the insertion sequence within 
the file. After processing an INSERT_LINE_BEFORE command, the 
pointer is at the same position it occupied before the command 
was issued. 
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TERMINATING VEDIT 


The user issues one of the following commands to end the editing 
session. 

END Terminates editing and saves the edit file. 

STOP Terminates editing and does not save the edit 

file. 

TERMINATING VEDIT WITH EDITING CHANGES SAVED 

When the user wants to terminate VEDIT execution and keep the 
edited file, an END command is issued. When the command is 
entered, the edit file is written onto the file specified on the 
END command. VEDIT then terminates its execution. 

TERMINATING VEDIT WITHOUT SAVING EDITING CHANGES 

The user issues a STOP command to terminate VEDIT without saving 
the edited version of the file. The file is left exactly as it 
appeared before VEDIT was called into execution. 
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COMMANDS AND SUBCOMMANDS 


This section contains individual descriptions of each VEDIT sub- 
command; it also contains individual descriptions of the command 
that initiates VEDIT execution. The descriptions are presented 
in alphabetical order by name. 

CHANGE_STR I NG 15 

CHANGE S_STR I NG 17 

DELETE_LINE 18 

EDI T_F I LE_L I NE_MODE 19 

END 20 

INSERT_LINE 22 

I NSERT_L I NE_BEFORE 24 

LOCATE_STR I NG 26 

MOVE_TO_BOTTOM 27 

MOVE_TO_NEXT_L I NE 28 

MOVE_TO_TOP 29 

PRINTLINE 30 

STOP 31 


PRECEDING PAGE BLANK NOT 
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COMMAND AND SUBCOMMAND FORMAT 


The VEDIT subcommands use the SCL command syntax. For a complete 
description of the SCL command syntax, refer to the SCL Language 
Definition manual. 

The following is a list of reminders when using SCL command 
syntax . 

- The abbreviation for each command, subcommand, or parameter 

name follows the name in the individual command, subcommand, 
or parameter description. The standard abbreviation 

convention for command and subcommand names is the first 
three characters of the first word plus the first character 
of each succeeding word. 

- Each subcommand also has an alias that closely resembles a 
NOS XEDIT command. 

- A delimiter character must separate the command or sub- 
command name from the parameter list, each parameter within 
the parameter list, and each value specified for a 
parameter. A valid delimiter character is either a comma or 
a space. 

- Each parameter has a name. You specify a parameter value 
either by specifying the value after the parameter name and 
an "=" character, or by specifying the value alone in its 
position within the parameter list. When you specify 
parameter values using their parameter names, you can enter 
the parameter values in any order. 

- You can use more than one line to enter a subcommand. The 
second and subsequent lines are called continuation lines. 
To continue a subcommand on the next line, enter an ellipsis 
(..) at the end of the line. 

- SCL interprets uppercase and lowercase letters the same 
within a name. However, SCL distinguishes between uppercase 
and lowercase within a string. Therefore, you must specify 
uppercase or lowercase letters as found in text when 
specifying a string search, as in using the LOCATE_STRING 
command. 
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COMMAND AND SUBCOMMAND DESCRIPTION FORMAT 


Each command or subcommand description in this manual provides 
the following information. 

- Command or subcommand name with its abbreviation and 

aliases . 

- Brief statement of the command or subcommand function. 

- Format including both singular and plural forms of the 

command or subcommand name and the position of each 

parameter in the parameter list. 

- Parameter value kinds. Within the command or sub-command 
format, each parameter name is equated to a word indicating 
the parameter value kind. For information on parameter 
value kinds, refer to the SCL Language Definition manual. 

- Parameter name forms. Each parameter description lists the 

singular and plural forms of the parameter name and its 

abbreviation in parentheses. 

- Brief statement of the function of each parameter. 

- Indication of whether the parameter is required or optional 
and, if optional, the default value. 

- Additional remarks on command or subcommand options and 
processing details. 

- Brief example using the command or subcommand. 
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CHANGE_STRING 


Purpose Replaces one string with a different string of any 
length and character content. However to use the edited 
file within NOS/VE, the user should not create a file 
line longer than 80 characters. The search for the 
first specified string starts at the line designated by 
the current pointer position. 

Format CHANGE_STR I NG 

or 

CHAS 

or 

CHANGE 

or 

C 

STRINGl=string 

STRING2=string 

NUMBER=integer 

Parameters 

STRING1 or SI 

String to be replaced. If omitted, STRING2 is inserted 
before the leftmost character of the line(s). 

STRING2 or S2 

String to replace stringl (can be any length). If 
omitted, STRING1 is deleted. 

NUMBER or N 

Number of lines containing an occurrence of stringl 
which should be changed. VEDIT changes every 
occurrence of stringl in the specified lines. If n is 
omitted, VEDIT changes the first line found containing 
stringl. Maximum value is 99999. If n is 0, the 
search for stringl is restricted to the current line. 

Examples xhis Vtuix session uses Lue orlANGE STRING ccfiuuaiicl to 

replace every instance of "EXT " in file to "865-". 
VEDIT verifies which lines are changed. Then 
LOCATE_STRING locates the name "BEE" and changes it to 
"BEAN” 

/edit_file_line_mode f=employ_addr 
NOS/VE VEDIT January 1, 1987 
VED/print 99 

##NAMES/ADDRESSES ARE FICTITIOUS## 

M. T. JONES 

1244 WILSHIRE ST ZIP 55722 
EXT 6533 
Q. E. SMITH 
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POB 55 ZIP 55703 
EXT 8837 
P. T. BEE 

8710 14TH ST ZIP 55713 
EXT 1890 
— EOI/TOP -- 

VED/change 'ext ' '865-' 99 

865-6533 

865-8837 

865-1890 

-- EOI/TOP -- 

VED/locate bee' 

P. T. BEE 

VED/change 'bee' 'bean' 

P. T. BEAN 
VED/ 
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CHANGES_STRING 


Purpose Replaces one string with a different string of any 
length and character content. However to use the edited 
file within NOS/VE, the user should not create a file 
line longer than 80 characters. The search for the 
first specified string starts at the line designated by 
the current pointer position. 

Format CHANGE S_STR I NG 

or 

CHANGES 

or 

CS 

STRINGl=string 

STRING2=string 

NUMBER=integer 

Parameters 

STRING1 or SI 

String to be replaced. If omitted, STRING2 is inserted 
before the leftmost character of the line(s). 

STRING2 or S2 

String to replace stringl (can be any length). If 
omitted, STRING1 is deleted. 

NUMBER or M 

Number of occurrences of stringl that are to be 
replaced. If the user omits the "m" value, VEDIT 
replaces only the next occurrence of the string. 

Example This VEDIT session uses the CHANGE S_STR I NG command to 
delete the first occurrence of the string "EE" from a 
line without changing any other occurrence of the 
string on the line. 

VED/print 5 
POB 55 ZIP 55703 
EXT 8837 
P. TEE BEE 

8710 14TH ST ZIP 55713 
EXT 1890 
-- EOI/TOP -- 
VED/changes 'ee' 

P. T. BEE 
VED/ 
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DELETE LINE 


! 


Removes an entire line(s); leaves the file pointer 
positioned at the line after the last line deleted. 

DELETE_LINE 
or 

DELL 

or 

DELETE 
or 
D 

STRING=string 
NUMBER= integer 

Parameters 

STRING or S 

String of characters that determines if a line should 
be deleted. If omitted, the next "number" lines are 
deleted. 

NUMBER or N 

Number of lines starting at the current pointer 
position that are to be deleted. The maximum value is 
99999; the default value is 1. Ifn isO, the line at 
the current pointer position is deleted. 

Example This VEDIT session uses the DELETE_LINE command to 
delete selective consecutive lines and lines containing 
a specific string. 

VED/print 
B. P. PEPPERS 
VED/delete 3 
B. P. PEPPERS 

116 WEST ELM DRIVE ZIP 55648 
EXT 3222 
VED/print 
P. T. BEE 

VED/delete n=99 s='ext' 

EXT 6533 
EXT 5339 
EXT 67 
EXT 1101 
-- EO I/TOP -- 
VED/ 


Purpose 

Format 
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EDIT F I LE_L I NE_MODE 


Purpose Begins an Edit_File_Line_Mode_Utility session. The 
utility edits the specified file. 

Format EDI T_F I LE_L I NE_MODE 

or 

EDIFLM 

or 

VEDIT 

INPUT_FILE= file 
FSTAT= key 
INPUT= file 
OUTPUT= file 
STATUS=status variable 


Parameters 

INPUT_FILE or F 

File to be edited. This is a required parameter. 

FSTAT 

KEY = c, if user wishes to create file with VEDIT. 

INPUT or I 

File from which VEDIT reads its input. The default 
value is $ local . command, which is usually connected to 
the terminal screen. 

OUTPUT or O 

File to which VEDIT output is written. The default 
value is $OUTPUT, which is the terminal screen. 

STATUS or S 

Specifies the termination condition of the command. 

Remarks The utility session ends when you enter a QUIT, END, or 
STOP subcommand . 
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END 


Purpose Terminates VEDIT execution and keeps the edited file. 

When the command is entered, the edit file is written 
onto the specified file (the fname parameter). VEDIT 
then terminates its execution. 

Format END 

or 

QUIT 

FNAME=f ile 


Parameters 

FNAME or F 

File name to be given the edit file upon leaving VEDIT. 
If the name is not entered, VEDIT uses the name 
specified for the edit file when VEDIT was called. 

Example This VEDIT session uses the END command to save the 
edited file in a new file, leaving the original file 
unchanged . 

VED/change 'ext' 'extension' 99 

EXTENSION 6533 

EXTENSION 5339 

EXTENSION 6778 

EXTENSION 1101 

— EOI/TOP -- 

VED/end f=address 

Changes to file saved in file: . VE1 . VERPG. EMPLOYEE_FIL- 

ES. ADDRESS 

/copy_file employ_addr 
M. T. JONES 

1544 WILSHIRE ST ZIP 55722 

EXT 6533 

A. B. MACDONALD 

1313 LEMONTREE AVE ZIP 55722 

EXT 5339 

T. G. SLATER 

322 WILSHIRE ST ZIP 55722 
EXT 6778 
R. C. CARTER 

6100 WILSHIRE ST ZIP 55722 
EXT 1101 

/copy_file address 
M. T. JONES 

1544 WILSHIRE ST ZIP 55722 
EXTENSION 6533 
A. B. MACDONALD 
1313 LEMONTREE AVE ZIP 55722 
EXTENSION 5339 
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T. G. SLATER 

322 WILSHIRE ST ZIP 55722 
EXTENSION 6778 
R. C. CARTER 

6100 WILSHIRE ST ZIP 55722 
EXTENSION 1101 
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INSERT_LINE 

Purpose Insert a specific number of lines into a file 
immediately after the line at the current pointer 
position. 

Format INSERT_LINE 
or 

INSL 

or 

INSERT 

or 

I 

NUMBER=integer 

Parameters 

NUMBER or N 

Number of lines which the user wants to insert. The 
maximum value is 99999; the default value is 1. If n 
is 0, VEDIT assumes that one line is to be inserted. 

Remarks When the user enters the INSERT command, VEDIT prints a 
single question mark to prompt entry for the first line 
to be inserted. VEDIT continues to print single 
question mark prompts until the specified number of 
lines to be inserted has been entered. If the user 
enters a carriage return immediately after the ? 
prompt, VEDIT stops processing the INSERT command and 
requests the next command. To insert a blank line, the 
user enters a space before the carriage return. After 
processing an INSERT command, the file pointer is 
positioned at the last line inserted. 

Example This VEDIT session uses the INSERT_LINE command to add 
three lines. 


VED/print 
EXT 6533 
VED/insert 3 
? a. b. newton 

? 160 haskell circle zip 55713 

? ext 227 

VED/top 

VED/print 7 

M. T. JONES 

1544 WILSHIRE ST ZIP 55713 
EXT 6533 
A. B. NEWTON 

160 HASKELL CIRCLE ZIP 55713 
EXT 227 


22 



T. T. SLATER 
VED/ 


INSERT_LINE_BEFORE 


Purpose Insert a specific number of lines into a file 

immediately before the line at the current pointer 
position. 


Format I N SERT_L I NE_BE FORE 

or 

INSLB 

or 

INSERTB 

or 

IB 

NUMBER=integer 


Parameters 

NUMBER or N 

Number of lines which the user wants to insert. The 
maximum value is 99999; the default value is 1. If n 
is 0, VEDIT assumes that one line is to be inserted. 

Remarks When the user enters the INSERTB command, VEDIT prints 
a single question mark to prompt entry for the first 
line to be inserted. VEDIT continues to print single 
question mark prompts until the specified number of 
lines to be inserted has been entered. If the user 
enters a carriage return immediately after the ? 
prompt, VEDIT stops processing the INSERTB command and 
requests the next command. To insert a blank line, the 
user enters a space before the carriage return. After 
processing an INSERTB command, the file pointer is at 
the position it occupied before the command was issued. 

Example This VEDIT session uses the INSERT_LINE_BEFORE command 
to insert three lines before the pointer position. 


VED/ print 

T. G. SLATER 

VED/insertb 3 

? a. p. jones 

? 160 hood ave zip 55713 

? ext 0842 

VED/top 

VED/print 7 

M. T. JONES 


1544 WILSHIRE 

ST 

ZIP 55713 

EXT 6533 



A. P. JONES 



160 HOOD AVE 

ZIP 

55713 


EXT 0842 
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T. G. SLATER 
VED/ 


LOCATE_STRING 


Purpose Allows the user to advance the pointer to a line 
containing a specific string of alphanumeric 
characters . 

Format LOCATE_STR I NG 

or 

LOCS 

or 

LOCATE 

or 

L 

STRING=string 
NUMBER= i nte ge r 


Parameters 

STRING or S 

String of alphanumeric characters which VEDIT attempts 
to locate. 

NUMBER or N 

Number of lines to be located containing the specified 
string. The pointer is positioned at the last line 
located. The maximum value is 99999; the default value 
is 1. If n is 0, the search is restricted to the 

current line. 

Remarks When the user issues a LOCATE_LINE command, VEDIT 
prints the n lines containing the specified string. 
The pointer is positioned at the last line printed. If 
the string is not found, the pointer is positioned at 
the top. 

Example This VEDIT session uses the LOCATE_STRING command to 
find a specified string and demonstrates the error 
message that is displayed if the specified string is 
not contained in the file. 

VED/locate 'zip' 

1544 WILSHIRE ST ZIP 55722 
VED/ locate '8711' 

-- EO I/TOP -- 
STRING NOT FOUND 
VED/ 
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MOVE_TO_BOTTOM 

Purpose Position the pointer at the End-of- Information. 

Format MOVE_TO_BOTTOM 
or 

MOVTB 

or 

BOTTOM 

or 

B 


Example This VEDIT session uses the MOVE_TO_BOTTOM command to 
move the pointer to the last line of the file. 

VED/bottom 
EXT 1890 
VED/print 5 
EXT 1890 
— EO I/TOP -- 
VED/ 
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MO VE_TO_NEXT_L I NE 

Purpose Allows the user to advance the pointer to the next line 
of the file in a forward or reverse direction. 

Format MO VE_TO_NEXT__L I NE 

or 

MOVTNL 

or 

NEXT 

or 

N 

NUMBER=integer 

Parameters 

NUMBER or N 

Number of lines that the pointer is advanced. To move 
in the reverse direction, a negative value is entered. 
The maximum value is 99999; the default value is 1. 

Remarks Reverse pointer movements are much slower than forward 
pointer movements. 

Example This VEDIT session uses the MOVE_TO_NEXT_LINE command 
to move the pointer through the file. 

VED/print 6 
M. T. JONES 

1544 WILSHIRE ST ZIP 5572 
EXT 6533 
A. B. NEWTON 

166 HASKELL CIRCLE ZIP 55713 

EXT 227 

VED/next -3 

EXT 6533 

VED/ 
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MOVE_TO_TOP 


Purpose 

Format 


Position the pointer at the beginning-of-information 


MOVE_TO_TOP 

or 


MOVTT 

TOP 

T 


or 

or 


Example This VEDIT session uses the MOVE_TO_TOP command to move 
the pointer to the first line of the file. 

VED/print 
Q. E. SMITH 
VED/top 
VED/print 

## NAMES/ADDRESSES ARE FICTITIOUS ## 

VED/ 
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PRINTLINE 


Purpose List lines from the current pointer position. 

Format PRINTLINE 
or 

PRIL 

or 

PRINT 

or 

P 

NUMBER=integer 

Parameters 

NUMBER or N 

Number of lines the user wants printed. The maximum 
value is 99999; the default value is 1. 

Remarks When the listing is finished, the pointer is positioned 
at the last line printed. If an end-of-information is 
read, printing stops and the pointer is positioned at 
the beginning of the file. 

Example This VEDIT session uses the PRINT_LINE command to 
display the file. 

VED/print 
Q. E. SMITH 
VED/print 4 
Q. E. SMITH 
POB 55 ZIP 55713 
EXT 8760 
-- E0I/T0P — 

VED/print 2 

## NAMES/ADDRESSES ARE FICTITIOUS ## 

M. T. JONES 
VED/ 
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STOP 


Purpose 

Format 

Example 


Terminates VEDIT without saving the edited version of 
the file. The file is left exactly as it appeared 
before VEDIT was called into execution. 

STOP 

This VEDIT session is ended using the STOP command. 
The changes made to the file are not saved. 

/edit_file_line_mode f=address 
NOS/VE VEDIT JANUARY 12, 1987 
VED/delete 10 
R. C. CARTER 

6100 WILSHIRE ST ZIP CODE 55722 
EXT 1101 
-- EOI/TOP -- 
VED/stop 

CHANGES MADE TO FILE NOT SAVED. 

/edit_f ile_line_mode f=address 
NOS/VE VEDIT JANUARY 12, 1987 
VED/print 10 
R. C. CARTER 

6100 WILSHIRE ST ZIP CODE 55722 
EXT 1101 
-- EOI/TOP -- 
VED/ 
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GLOSSARY 


Alphanumeric 

Consisting of alphanumeric and/or numeric characters only. 
Batch Mode 

A mode of execution where a job is submitted and processed 
as a unit without intervention from the user. Contrast with 
Interactive Mode. 

Beginning-of- Information (BOI) 

File boundary that marks the beginning of a file. 

Binary File 

A nonedi table file containing non- text/non- coded format. 


BOI 


See Beginning-of- Information. 

Catalog 

A directory of files and catalogs maintained by the system 
for a user. The catalog $LOCAL contains only file entries. 

Also the part of a path that identifies a particular catalog 
in a catalog hierarchy. The format is as follows: 

name . name .... name 

Wiicic cadi name is a catalog . See CaLeiloy Name and Path. 


Catalog Name 

The name of a catalog in a catalog hierarchy (path) . By 
convention, the name of the user's master catalog is the 
same as the user's user name. 

Command 

A set of characters used to signify a specific set of 
instructions in a time-sharing subsystem. Commands that can 
only be entered from within the editor are editor 
subcommands . 


33 




A i.C; 




, wmmmx blank 


Command List 


One or more entries that define the commands that are 
currently available. A command list entry is an object 
library, catalog, or special entry $ SYSTEM. 

Command Utility 

A NOS/VE processor that adds its command table (referred to 
as its subcommands) to the beginning of the SCL command 
list. The subcommands are removed from the command list 
when the processor terminates. 

Control Statement 

A set of characters used to signify a specific set of 
instructions for a batch job. 

Current Line 

Line at which the pointer is positioned. The last line 
processed by a command (usually the last line printed) . 

Default Value 

A predetermined value assigned to a parameter. 

Delimiter 

The string delimiter is a single quote ( ' ) . Parameter 
delimiters can be any valid NOS/VE delimiter. 

End-of-Information (EOI) 

The point at which data in the file ends. VEDIT prints the 
-- EOI/TOP -- message when EOI is encountered. 

-- EOI/TOP -- 

A message printed when command processing reaches the end of 
the file being edited. 

Family 

A logical grouping of NOS/VE users that determines the 
location of their permanent files. A family can be 
subdivided into accounts and projects. 

Family Name 
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A name that identifies a NOS/VE family. See Family. 

Family Path 

Identifies a file via a family name and a user path as 
follows: 


File 


: family name. user path 
OR 

$FAMILY.user path 


An SCL element specifying a temporary or permanent file, 
including its path and, optionally, a cycle reference (for 
permanent files). A file is identified by specifying a path 
and, optionally, a cycle reference as follows: 

path. cycle reference 

A set of information that begins at beginning-of- 
information (BOI) and ends at end-of-information (EOI), and 
is referred to by a file name. 

File Name 


The name of a NOS/VE file. It is used in a file reference 
to identify the file. See Name. 


Interactive Mode 


A mode of execution where a user enters commands at a 
terminal and each command elicits a response from the 
computer. Contrast with Batch Mode. 


Job 


A set of tasks executed for a user name. NCS/V 
interactive and batch jobs. In interactive mode, 
usually the same as a terminal session. 


a job is 


Local File 


A file that is accessed via the local catalog named $LOCAL. 
This file no longer exists once the user logs off. See also 
File, Path, Local Path. 


Local File Name 


The name used by an executing job to reference a file while 
the file is assigned to the job's $LOCAL catalog. Only one 
file can be associated with a given name in one job; 
however, in one job a file can have more than one instance 
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of the file open by that name. 

Local Path 

Identifies a local file as follows: 
$LOCAL.file name 


Path 


Identifies a file. It may include a family name, user name, 
subcatalog name or names, and file name. 

Permanent Catalog 

A catalog of permanent files. 

Permanent File 

A file that does not go away when you log off or when the 
system is deadstarted. A permanent file has an entry in a 
permanent catalog. See File. 

Pointer 

A position indicator; in VEDIT, for example, it identifies 
the line at which VEDIT will start processing a command. 

SCL 

Source Code Language provides the user interface to NOS/VE. 
Source Program 

A program written in a high-level language such as BASIC or 
FORTRAN and stored in a format that can be edited. 

String 

A set of characters bounded on each end by a single quote 
mark. 

Subcommand 

A command that can only be entered and recognized from 
within the editor utility. 

User Path 

Identifies a file or catalog via a user name and optionally 
a relative path as follows: 
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Utility 


.user name. relative path 
OR 

$USER. relative path 


See Command Utility. 

Working Catalog 

The catalog prefixed to a file reference that begins with a 
name (that is not a period, colon, or a system name 
beginning with a dollar sign). The working catalog is the 
catalog used if no other catalog is specified on a file 
reference. 
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SUMMARY OF VEDIT COMMANDS AND SYNTAX 


This section gives a short summary of the VEDIT commands and 
their NOS aliases. 

SUMMARY OF VEDIT COMMANDS 


CHANGE_STR I NG or 
CHANGE or C 


CHANGE S_ STRING or 
CHANGES or CS 


DELETE_LINE or 
DELETE or D 


END or QUIT 


INSERT_LINE or 
INSERT or I 


I NSERT_L I NE_BEFORE 
or INSERTB or IB 


LOCATE or L 


MOVE_TO_BOTTOM or 
BOTTOM or B 

MO VE_TO_NEXT_L I NE 
or NEXT or N 


MOVE_TO_TOP or 
TOP or T 


Replaces all occurrences of a 
particular string of characters with 
another string in a specified number of 
lines . 

Replaces one or more occurrences of a 
particular string of characters with 
another string. 

Deletes one or more lines from a file 
starting at the current pointer 
position or a particular number of 
lines on the basis of specified string 
criteria. 

Saves the edited file and terminates 
VEDIT execution. 

Inserts a specified number of lines 
into the file immediately after the 
line designated by the current pointer 
position. 

Inserts a specified number of lines 
into the file before the line 
designated by the current pointer 
position. 

r emA/N i f i niunkor A f 1 i noc 
uwu wvw M '*■' •*- w — 

that contain a particular string or 
strings of characters. The lines are 
printed. 

Finds the end-of-information of the 
file. 

Moves the file pointer from its current 
position forward or backward a 
specified number of lines. 

Moves the file pointer to the first 
line in the user's file. 
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PRINTLINE or 
PRINT or P 


Lists a specified number of lines, 
starting at the current pointer 
position. 


STOP 


Terminates VEDIT execution without 
saving the modified edit file. 
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